home *** CD-ROM | disk | FTP | other *** search
/ Sun Solutions 2000 #2 / Sun Solutions CD (Volume 2 2000)(Special Focus - Java Technologies)(Disc 1).ISO / products / Software / BostonBusinessComputing / bbc / README.VCL < prev    next >
Text File  |  2000-02-11  |  15KB  |  376 lines
  1.                                    README
  2.                                    ======
  3.  
  4.  
  5.                               VCL version 3.65
  6.  
  7.             Copyright 1985-1999 Boston Business Computing, Ltd.
  8.  
  9. 1. Introduction
  10. ===============
  11.  
  12.    Thank you for selecting VCL from Boston Business Computing, Ltd.
  13.  
  14.    This file contains the following sections:
  15.  
  16.       1. Introduction
  17.       2. Installation
  18.       3. Technical Support
  19.       4. Known problems
  20.       5. Differences Between VCL and VMS
  21.       6. Undocumented Features
  22.       7. Documentation Errors
  23.  
  24.    The documentation for VCL consists of the "VCL Reference Guide", the
  25.    "Installation and Troubleshooting" booklet, the online VCL help library,
  26.    and the online UNIX man page.
  27.  
  28.    The ID.VCL file describes all files in the VCL release.
  29.  
  30.  
  31. 2. Installation
  32. ===============
  33.  
  34.    Please refer to the "Installation and Troubleshooting" booklet.
  35.  
  36.  
  37. 3. Technical Support
  38. ====================
  39.  
  40.    Purchasing VCL entitles you to sixty days of free phone support via our
  41.    Technical Support Line.  The support line can be reached at (978)
  42.    725-3222.  Hours are 9:00-5:00 (Eastern) Monday through Friday.  Please
  43.    have your product serial number or maintenance authorization number
  44.    available when you call.  If you prefer, you may communicate problems,
  45.    questions, or enhancement requests via FAX (send to VCL Support at (978)
  46.    725-3229) or email (sales@bosbc.com).  We make every effort to respond to
  47.    queries from supported customers within two business days.
  48.  
  49.    Extended support can be purchased for an additional charge.  Extended
  50.    support entitles you to access to the Technical Support Line, priority
  51.    bug fixes and free maintenance updates during the term of the support
  52.    period.  Please contact our sales department for pricing.
  53.  
  54.    Customers who are not on support may communicate problems, questions or
  55.    enhancement requests via FAX or email (see above).
  56.  
  57.  
  58. 4. Known problems
  59. =================
  60.  
  61.    VCL will not work properly when invoked in a Sun CMDTOOL window.
  62.    Apparently it is not always possible to distinguish between a CTRL-J and
  63.    a CTRL-M in these windows, so pressing the enter key sends a CTRL-J to
  64.    VCL which causes the previous word to be deleted.
  65.  
  66.    This problem can be alleviated by using a ShellTool or xterm window.
  67.  
  68.  
  69. 5. Differences Between VCL and VMS
  70. ==================================
  71.  
  72.    SORT and MERGE
  73.       Files that exist cannot be specified as the target files for the SORT
  74.       and MERGE commands.  They will not be overwritten.  VCL does not
  75.       support version numbers.
  76.  
  77.    /BEFORE and /SINCE Qualifiers
  78.       The /BEFORE and /SINCE qualifiers do not currently reject delta time
  79.       specifications.
  80.  
  81.    COMMAND HISTORY
  82.       The command history is circular.  After displaying all (128 maximum)
  83.       of the previous commands, the up-arrow key will redisplay the most
  84.       recent command entered.
  85.  
  86.    SET HOST
  87.       With Vnet installed, SET HOST will translate to the configured
  88.       network's equivalent SET HOST command.  For example, if you are using
  89.       DECnet under ULTRIX, the SET HOST command translates to `dlogin'.
  90.  
  91.       By not installing Vnet, the SET HOST command assumes TCP/IP protocol
  92.       and uses `rlogin'.
  93.  
  94.    SHOW NETWORK
  95.       The implementation of SHOW NETWORK may vary on certain UNIX systems.
  96.       If you have Vnet installed, the display will vary based on your Vnet
  97.       configuration file.  The display also will vary depending on which
  98.       networking package you are using.
  99.  
  100.       If you do not have Vnet installed, the UNIX `ruptime' command executes
  101.       by default.
  102.  
  103.  
  104. 6. Undocumented Features
  105. ========================
  106.  
  107.    DECRYPT/BY_OWNER[=uic]
  108.       Decrypts only those files of the specified user.
  109.  
  110.    DEFINE/KEY
  111.       The DEFINE command now has the /KEY qualifier.
  112.  
  113.       Syntax: DEFINE/KEY key-name equivalence-string
  114.  
  115.       Parameters:
  116.  
  117.          key-name:
  118.             Specifies the name of the key that you are defining.  The
  119.             following table lists the key names on various terminals.
  120.  
  121.                Key-name            VT220               VT100
  122.                _____________________________________________
  123.                PF1                 PF1                 PF1
  124.                PF2                 PF2                 PF2
  125.                PF3                 PF3                 PF3
  126.                PF4                 PF4                 PF4
  127.                KP0,KP1,...KP9      0,1,...9            0,1,...9
  128.                PERIOD              .                   .
  129.                COMMA               ,                   ,
  130.                MINUS               -                   -
  131.                ENTER               Enter               ENTER
  132.                LEFT                <--                 <--
  133.                RIGHT               -->                 -->
  134.                Find (E1)           Find                --
  135.                Insert Here (E2)    Insert Here         --
  136.                Remove (E3)         Remove              --
  137.                Select (E4)         Select              --
  138.                Prev Screen (E5)    Prev Screen         --
  139.                Next Screen (E6)    Next Screen         --
  140.                HELP                Help                --
  141.                DO                  Do                  --
  142.                F6,F7,...F20        F6,F7,...F20        --
  143.                BS                  <---BkSp            <---BkSp
  144.                DEL                 DEL                 DEL
  145.  
  146.          equivalence-string:
  147.             Specifies the string that is to be processed when you press the
  148.             key.  If the string contains any spaces, enclose the equivalence
  149.             string in quotation marks.
  150.  
  151.       DEFINE/KEY Command Qualifiers:
  152.  
  153.          /ECHO (default)
  154.          /NOECHO
  155.             Determines whether the equivalence string will be displayed on
  156.             your screen after pressing the key.  You cannot use/NOECHO with
  157.             the /NOTERMINATE qualifier.
  158.  
  159.          /IF_STATE=(state-name,....)
  160.          /NOIF_STATE
  161.             Specifies a list of one or more states, one of which must be
  162.             selected for the key definition to be in effect.  If you omit
  163.             the /IF_STATE qualifier or use /NOIF_STATE, the VCL uses the
  164.             current state.  The state name is an alphanumeric string.
  165.             States will be established with the /SET_STATE qualifier or the
  166.             SET KEY command.  If you specify only one state name, you can
  167.             omit the parentheses.  By including several state names, you can
  168.             define a key to have the same function in all of the specified
  169.             states.
  170.  
  171.          /LOCK_STATE
  172.          /NOLOCK_STATE (default)
  173.             Specifies that the state set by the /SET_STATE qualifier remain
  174.             in effect until explicitly changed.  If you use the
  175.             /NOLOCK_STATE qualifier, the state set by /SET_STATE is in
  176.             effect only for the next definable key that you press or for the
  177.             next read terminating character that you type.
  178.  
  179.             The /LOCK_STATE qualifier can only be specified with the
  180.             /SET_STATE qualifier.
  181.  
  182.          /SET_STATE=state-name
  183.          /NOSET_STATE (default)
  184.             This will cause the specified state-name to be set when pressing
  185.             the key.  The state name can be any alphanumeric string.  If you
  186.             omit the SET_STATE qualifier or use /NOSET_STATE, the locked
  187.             current state that remains in effect.
  188.  
  189.          /TERMINATE
  190.          /NOTERMINATE (default)
  191.             Specifies whether the current equivalence string is to be
  192.             terminated or processed when pressing the key.  Pressing RETURN
  193.             has the same effect as using /TERMINATE.
  194.  
  195.             The /NOTERMINATE qualifier allows you to create key definitions
  196.             that insert text into command lines, after prompts, or into
  197.             other text that you are typing.
  198.  
  199.       NOTE: There are two problems with the qualifiers that go with
  200.       DEFINE/KEY:
  201.  
  202.          /LOCK_STATE
  203.             This qualifier does not function correctly in the define key
  204.             command.
  205.  
  206.          /NOECHO with /NOTERMINAL
  207.             Using the /noecho qualifier along with the /noterminal qualifier
  208.             when using the define key command, the /noecho qualifier should
  209.             be ignored but it isn't.  VMS ignores the /noecho.  This means
  210.             that an invisible equivalence string will be placed on the
  211.             command line whenever pressing the defined key.
  212.  
  213.    DELETE/SYMBOL
  214.       Identifies the first parameter as a symbol, not a file specification.
  215.  
  216.       Qualifiers:
  217.  
  218.          /ALL
  219.             Deletes all the symbols and their values in the specified symbol
  220.             table.
  221.  
  222.          /LOG
  223.          /NOLOG (default)
  224.             Displays the specification of each symbol deleted.
  225.  
  226.    ENCRYPT/BY_OWNER[=uic]
  227.       Encrypts only those files of the specified user.
  228.  
  229.    LOGICAL UNIT NUMBERS
  230.       Logical Unit Numbers are not supported, however, you can use
  231.       environment variable settings.  From within VCL execute the following
  232.       command:
  233.  
  234.          assign test.dat SYS$FOR005
  235.  
  236.       From that point, use a call from the program to obtain the value of
  237.       the environment variable, like the following command:
  238.  
  239.          getenv (VARIABLE)
  240.  
  241.       A check of the system environment will show the value of the
  242.       variable,and the SYS$ will be stripped off the variable:
  243.  
  244.          FOR005=test.dat
  245.  
  246.       Logical unit numbers will be considered for a future release.
  247.  
  248.    PHONE
  249.       Invokes the UNIX 'talk' utility.
  250.  
  251.       Syntax: PHONE user-name
  252.  
  253.    PROCESS/OUTPUT[=file-spec]
  254.       Writes the statistics of the specified process to a specified file.
  255.  
  256.    SEARCH/BY_OWNER[=uic]
  257.       Searches only those files of the specified user.
  258.  
  259.    SEARCH/NUMBERS
  260.       Determines whether the source line number will be displayed at the
  261.       left margin of each line in the output.
  262.  
  263.    SET FILE/PROTECTION=(ownership[:access],...)
  264.       Sets the protection of the file being modified.
  265.  
  266.    SET TERMINAL/INQUIRE
  267.       The SET TERMINAL/INQUIRE command sets the device type according to a
  268.       response elicited from the terminal.  The default is UNKNOWN.  This
  269.       command is both system and terminal dependent.  You can include the
  270.       SET TERMINAL/INQUIRE command in your SYS$LOGIN file automatically to
  271.       detect the terminal type.
  272.  
  273.    SHOW MEMORY
  274.       SHOW MEMORY (the vclshmem utility) is added for compatibility.  It
  275.       calls the 'vmstat' utility on systems where it is available.
  276.  
  277.       Note: The 'vclshmem' shell script is included for compatibility.  It
  278.       calls the 'vmstat' utility on systems where it is available.
  279.  
  280.    SHOW MEMORY/OUTPUT[=file-spec]
  281.       Writes the memory information to a specified file.
  282.  
  283.    SHOW QUEUE
  284.       The SHOW QUEUE command displays the printing queue for all attached
  285.       printers on your system.  The system command will be invoked directly:
  286.       'lpstat' for most System V UNIX systems and 'lpq' under most BSD UNIX
  287.       systems.
  288.  
  289.       Qualifiers:
  290.  
  291.          /FILES
  292.             The /FILES qualifier will be used to display the list of files
  293.             associated with each job.  The system command (for mosts BSD
  294.             systems) 'lpq -l' will be invoked directly.
  295.  
  296.             Note: The SHOW QUEUE/FILES command is only available on those
  297.             UNIX systems that use the UNIX 'lpq' command.
  298.  
  299.          /[NO]OUTPUT[=file-spec]
  300.             Writes all information about the queue to a specified file.
  301.  
  302.    SHOW SYSTEM/OUTPUT[=file-spec]
  303.       Writes the system information to the specified file.
  304.  
  305.    SHOW TERMINAL [device-name]/OUTPUT[=file-spec]
  306.       Writes the terminal information to the specified file.
  307.  
  308.    SPAWN/PROCESS=subprocess-name
  309.       Assigns the name of the subprocess.  The subprocess-name will be
  310.       displayed if the /LOG qualifier is specified.
  311.  
  312.    SET TERMINAL/APPLICATION_KEYPAD
  313.       The SET TERMINAL command now has the /APPLICATION_KEYPAD qualifier.
  314.       SET TERMINAL/APPLICATION_KEYPAD sets the keypad in APPLICATION KEYPAD
  315.       mode, which allows you to enter VCL commands defined with the
  316.       DEFINE/KEY command.
  317.  
  318.       Note: Set the keypad to NUMERIC KEYPAD mode to use numbers and
  319.       punctuation marks.
  320.  
  321.    SET TERMINAL/NUMERIC_KEYPAD
  322.       The SET TERMINAL command now has the /NUMERIC_KEYPAD qualifier.  SET
  323.       TERMINAL/NUMERIC_KEYPAD sets the keypad in NUMERIC KEYPAD mode, which
  324.       allows you to type numbers and punctuation marks.
  325.  
  326.       Note: Set the keypad to /APPLICATION_KEYPAD mode to use the DEFINE/KEY
  327.       command.
  328.  
  329.    LNM$GROUP AND LNM$SYSTEM
  330.       In the VMS environment, logicals defined in the LNM$SYSTEM table can
  331.       be shared by all processes.  Additionally, those logicals defined in
  332.       the LNM$GROUP table can be shared by all members of a particular
  333.       group.  While running VCL on many UNIX systems, logicals defined in
  334.       the LNM$SYSTEM and LNM$GROUP tables can be accessed by other VCL
  335.       processes.  In LNM$SYSTEM logicals, all VCL processes may access these
  336.       logicals.  Only those processes with root privileges, however, may
  337.       modify the shared LNM$SYSTEM table.  All logicals defined in the
  338.       LNM$GROUP tables may be accessed and modified by those in the same
  339.       group.  Logicals stored in the LNM$SYSTEM and LNM$GROUP tables will
  340.       remain present until the system boots.  To determine if your system
  341.       uses shared tables, use the SHOW VCL command.
  342.  
  343.    SHOW DEVICES
  344.       Under UNIX, adding SHOW DEVICES (the vclshdev utility) was for
  345.       compatibility.  It calls the UNIX 'df' utility.
  346.  
  347.    SHOW MEMORY
  348.       Under UNIX, adding SHOW MEMORY (the vclshmem utility) was for
  349.       compatibility.  It calls the 'vmstat' utility on systems where it is
  350.       available.
  351.  
  352.  
  353. 7. Documentation Errors
  354. =======================
  355.  
  356.    The following commands appear in the VCL manual but are not implemented
  357.    in this version of VCL: PRINT/LOWERCASE, SET TERM/WIDTH, SET
  358.    HOST/DEC/TCP, STOP/ENTRY, and WRITE/SYMBOL.
  359.  
  360.    SET VERIFY (page 117) is described incorrectly in the manual.  PROCEDURE
  361.    and IMAGE are arguments, not qualifiers.  The correct text follows:
  362.  
  363.    Syntax: SET [NO]VERIFY[=([NO]PROCEDURE, [NO]IMAGE)]
  364.  
  365.    Echoes executed command procedure lines to the terminal.
  366.  
  367.    Arguments:
  368.  
  369.       PROCEDURE (default)
  370.       NOPROCEDURE
  371.          Echoes each VCL command in a command procedure to the terminal.
  372.  
  373.       IMAGE (default)
  374.       NOIMAGE
  375.          Echoes data lines to the screen.
  376.